Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Media Samples

GetMovieDataSize

The GetMovieDataSize function allows your application to determine the size, in bytes, of the sample data in a segment of a movie.

pascal long GetMovieDataSize (Movie theMovie, TimeValue startTime, 
                              TimeValue duration);

theMovie

Specifies the movie for this operation. You obtain this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

startTime

Contains a time value specifying the starting point of the segment.

duration

Contains a time value that specifies the duration of the segment.

DESCRIPTION

The GetMovieDataSize function returns a long integer that contains the size, in bytes, of the movie's sample data that lies in the specified segment. GetMovieDataSize counts each use of a sample. That is, if a movie uses a given sample more than once, the size of that sample is included in the returned size value one time for each use. Consequently, the returned size is greater than or equal to the actual size of the movie's sample data, and corresponds to the amount of movie data that will be retrieved when you call the FlattenMovie function or FlattenMovieData function (described on page 2-93 and page 2-94, respectively).

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidDuration	-2014	This duration value is invalid
invalidTime	-2015	This time value is invalid